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INTRODUCTION 


"HI-2" E a modification of Ray Kingsley’s  HOT-Z Il for the 
2X8i/TS1i000/TSi500. I develeped it primarily for my cwn uses as a software 
Ceveicper; however, Fay and I both felt that other users could benefit from 
this, so deciced to make it availabie to licansed users of Hot Z at a nomina! 
upcate charge. 

HI-Z is completely relocated into the 


JO-EFFF block of memory (22-48K). The 
mes totally "programmer transparent,’ 
ce from 4000-7FFrF free for your 
t g load, run, and/or test your own 
to make changes or write new code, 


S00 
bea o of this its that Hot 2 becom 

leaving the entire "user RAM" spa 
applications. You can therefore quit Ho 

pregrams, and jump right Gack inte Hot 2 

LEAVING YOUR PROGRAM COMPLETELY INTACT. 


For example, I recently wrote a long machine-code game whose code and data 
takes up the entire region from 2000 to 3000h. Without HI-Z, such a program 
could have only been written by the "patchwork" method; time-consuming, 
frustrating, and highly prone te relocation errors. Using a conventional! 
assembler, euch a chore could take years for the average casual programmer. 
Even with the original Het Z, it could take many months. With HI-Z, the task 
was greatly simplified, making it possible to write seme 12K of code within 
about six weeks, 


Since HI-2 initializes RAMTCP to S000h and then places itself above this, it 
is also highiy immune to what I term "soft" crashes; i.e. crashes that only 
reset the machine without rampant runaway LBIR’=, etc. 


Adcciticna! acvantaces will Beccme clear as we cover the "fine points" of the 
HI-Z version of Hat 
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TREORY 
cst of you Knew that ycu can’t run machine-ceoce above the 32K mark. The 
reason may not be exactly clear, so here is a basic explanation. It has to do 
vith the way the video display system was designed. Whenever accrees line AIS 
is high (32-44K being adcressed) during an instruction fetch cycle (MI NOT, 
the ULA ‘custom iogic chip) swings inte action and forces NOPs onto the CFU 
in 


sata Bus. It turn reads the "instructions contained there as data for 

viceo Gisplay, relying on a high-memoery echo of the display file. This data 
i's then serially sent to the modulator te produce each horizontal TV line. 

The first such "instruction" with bit 4 high it taken as a zignal to the ULA 
that the cispiay cycle is over, causing it tc return MI control to the CPU. 
‘So vou see, it’s no accident that the display-file enc markers are HALT 
commands!) The bottom ine is that oniy opccces with bit 4 high will execute 
in high memory; the rest are simp!» read as NOPs! Pretty useless, alright. 
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Fortunately, oniy the top 16K is really needed for this. By including Al4 in 
the ULA Mi NOT decoding, we can restore true CFU instruction fetches in the 
3000-8FFF region. Note, however, that doing this prevents us from putting the 
display file there. Fortunately, there is little or no commercial software 
that relies on this "trick," so Mi NOT decoding only adversely affects the 
eccasionai large home-drew FA SIC program. 
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if the abeve discussion was over your head, don’t worry about it. All you 
really need to Know is that you need a minor modification to your computer to 
make HI-2 work with your 44K RAM pack. Details were published in Syncware 
News, Vol. 2 #5. These of you who dislike harcware hacking may be pleasec to 
knew that I^] make up a plug-in adaptor to do the job for $15. 


LEADING 


After powering up, simply LOAD "HI-2" or LCAD "". When loading is complete, 
the gcod old familiar Hot 2 cover screen will come up. As before, you can 
ma’. a back-up save by pressing $, or press any other Key to enter Hot 2. 


But iow you may also press the BREAK key. I completely re-worked Rays 
ioader, putting the whole werks inte BASIC. No longer is your uploader tucked 
away in the printer buffer, where it is instantly cleared the moment you 
return to BASIC and enter a command. The entire Hot Z code and data is stored 
in dimensioned string array At. An ordinary old BASIC PRINT statement prints 
the cover screen, and an ordinary old INKEY$ waits for a Keypress, etc. As a 
result, the KI-Z loader will be very easy to adapt to other mass-storage 
devices. Do note, however, that you must never use RUN, CLEAR, or redimension 
AS, or elise the HI-2 code and data wil! be lost. 


The actual uploader routine is stored in the traditional "i REM" area (4082). 
After entering Hot Z, the loader program will still be in place, so you can 
look it ayer and explore at leisure, (Hot 2 disassembled itself; HI-Z even 
Gisassembies where it came from!) 


COLD AND WARM BOOT 


As mentioned earlier, RAMTOP is initialized at 8000, with the stack 
immediately below. You can therefore QUIT to BASIC, NEW, and have your whole 
4000-7FFF area available for loading programs. Tc start Hot Z from a “cold 
boot," enter RAND USR 28912 (or other variant, such as RUN USR 38912, IF USE 
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SE912 THEN, etc.). This is exactly like USR 22323 in the 14K version, and 
fully ini teal tases stack, names files, variables, and so on. A cold 
beat may be done from either FAST or SLOW mace, 


ot 
Per 
D 
& 
ifi 
D 
= 


When werking on a program it is often advantageous to re-enter Hot Z using a 
Swarm bocet. ! This leayes your variables, user stack, and names files intact 

it eyen returns you to the next disassembly screen after the one you quit 
from. This warm entry point is at name CHOO (USR 43437). Note, however, that 
warm boot must always be from SLOW mode. If you accidentiy use FAST mode, all 
is nat est; your screen will be grey, But the program is actually running. 


le 
Press ENTER to be sure you’re in disassembly moce, followed by SHIFT Q to 
return te BASIC., Then enter SLOW mode and re-inycke the warm boot USR call. 
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MEMCRY MAF 


It is worthy of note that EVERY element of Hot 2 has been moved from its 
original location in the supplied versions. Doing partial relocations 


invelying only one or two elements is relatively straightforward, as 
described in the Hot 2 documentation. However, if you ever attempted a ful! 
Het Z relocation, you probably found out that there’s more than meets the 
eye. It takes a lot of trial and error, and no less than FOUR separate 
relocations plus a few manual touch-ups to get everything moved into high 
memory. The HI-Z memory map now looks as follows: 


G000-S0A7 HZ variables 
SOAE-S1iDC Jump tables 

21 DE-885F HZ files 

8840-9951 Free space for names 
SPERP-F7FE Resident names 
9800-BFIF HZ Program 

BFZO-BFFF Unused 


The region from BF20-BFFF is a handy place to put some of your own little 


EVEN MORE ON NAMES AND NAMING 


You’1l] note that there’s a great big gap, from 3860-9951, that is unused. [ 
set it up this way to allow expansion of the resident names file. Again by 
way of example, the 24K program referred to earlier simply didn’t have any 
room for its own alternate names file in low memory. What you can da in a 
similar situation is to use this blank area fer the ALNA files. Even better 
yet, simply add to the resident names? 


There are two things te take into account when adding your own names to the 
resident file. The first is that a cold boot will reinitialize NTOP to the 
original setting, i.e. 9552. So after you add your names, press SHIFT T from 
disassembly mode to get the current NTOP. Write this address to locations 
8354 and 8854 in the files area (as usual, in low-high order). This wilt 
cause a cold boot intentional or accidental, as by stumbling into an error 
traz or hitting SHIFT R by mistake) to respect your new NTOP, 


The other consideration is that the expanced names file will no longer fit 
into the loader. Some concessions are always necessary, anc I felt that the 
capability of leading into a machine with RAMTOP at S000 ‘as on power-up) 


overweighs the disadvantage of not being able to expand the names file. You 
can get around this in one of two ways: 


i: Make up a new loader, recimensioning AS as required and modifying the 
uploader ta suit your new Block sizes. 

lise alternate mass-storage to save the entire 3000-BFFF biock. For 
ple, the A&J Stringy-Floppy, the popular 2-XLR& tape package, and at 
ast two DOS packages allow such a code-save option. This essentially 
s the loader completely un-necessary. 
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I’ve taken the liberty of adding some of the most common ROM calls to the 
names file, but didn’t go "“whole-hag" on naming ROM routines. Personaliy i 
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prefer to have plenty of space available for whatever application I happen to 
be working on. 
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OTHER POINTES 


Aà minor bug that plagues Oliger video systems has been patched. This causec 
goofy behavior (even crashes) when trying te use the tape routines. Note, 
however, that when using the tape commands with Gliger video you will NOT get 
the border colour changes. Slightly annoying, but not fatai. 


A cold boot will re-initialize RAMTOP to 8000h. So if you move RAMTOP for 
whatever reason, be sure to use the warm boot to re-enter Hot Z after 
quitting to BASIC. For example, you might want to put the stack at C000 or 
higher, so that it’s completely out of the way of your “user” space from 2000 


ta 3000. 


You might note that HI-2 writes FAOG to (RAMTOP). This is for the benefit cf 
Compusa disk owners; this system uses these bytes to point at its directory. 
FA00 is about as high as you can put it without running into trouble. 


BEWARE of overflowing the user stack, or you’ii start running into the 
machine-stack! TROUBLE! 


As with earlier versions of Hot 2, you should be careful when single-stepping 
routines that write to the "unused" system variables (MEMé, printer buffer, 
etc.). The single-stepper relies on these to simulate registers, program 
counter, etc. Mess with this while single-stepping.... CRASH! 


The printer routines were patched so that they work with the Memotech or 
Aerco printer interfaces, as well as with the T2040. However, I found that 
occasionally the PRINT SCREEN (read mode shift Y) will print a double screen. 
I’m not sure why this is, but I think it has to do with the END setting. Put 
END scmewhere on the current screen, and this shouldnt happen. 


SOME BUGS AND GLITCHES 


Considering how many tries it tock before this relocation worked at all, I 
wae amazed that it ended up working as well as it does. To my Knowledge, only 
one bug crept in along the way, and even this will be serendipitous to many 


users (myself included). For some obscure reason, the character codes are no 
lenger printed after commands such as LD A,n and Chon. This will be a real 


toon to users of the Memotech interface, which can crash gloriously on some 
of the graphics codes. (For those of you who really really miss this feature, 
hang tight. Ray has agreed to took it over anc figure out what went wrong.) 


This next one is not so much a bug as it is an annoyance that plaques al} 
versions of Kot 2, including HI-Z. After quitting to BASIC, the error- 
handling system is left slightly out of whack. Uniess you have the program 
curzor early enough in a BASIC program to give a 3/0 report on quitting, the 
next command vou enter will zoof itself if it exceeds the length of one line. 
It’s annoying to type in some complex calculation, oniy to have it refuse to 
auto-scroll and give a S/(garbage) report when you reach the end of the line. 
I’ve gotten into the habit of typing FAST FAST FAST FAST FAST FAST FAST 
tehit F seven times} foilcwed oy DELETE, whenever quitting results in a K 
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curser instead of a 3/{garbage) error code. This restores the error-handler, 
and subsequent command lines will auto-scrolil like they should. 


If your application ‘or hardware) messes with location 407B (H2ET), you might 
get goofy behavicr or even crashes if you stumble into an error trap (RST 09) 
after a warm boot. Avoid this either by leaving 4075 alone, or by avoiding 
RST O06! 


Be careful about single-stepping IN and OUT commands, especially IN. I have 
had the single-stepper freeze up on occasion while single-stepping these 
commands. (The results you get are usually meaningless anyway, so you're best 
off just skipping IZO commands entirely.) 

BEWARE of naming (shift G) or deleting names ‘shift 3) from data mode. At 
est it won’t take, at worst you’!!1 lock up. 


EPROMing HI-Z 


It might be really neat to have HI-2 on a 2764 EPROM, mapped at SOQ00-SFFF. I 
hayen’t Gone it myself, but it should be quite easy to do. The only thing you 
need to remember is that HI-2’s read/write variables are at S$000-S0A7. You'll 
therefore have ta move these into RAM somewhere, as in low memory (2000-3FFF) 
cr above C000. Since this is a one-step relocation, it should pose no 
problems. See Ray’s notes on relocating Hot Z. 


Fred Nachbaur 


